Cromemco Software Update Service Note Z80 Cromix~7 


Date: _ December 21, 1983 
Product:_CROMIX-L and CROMIX-S 


- Release: 8 — 


- CORRECTIONS 


Date production of this version began: De see, 1983 on 8" 
Dec 8 " 


First serial number with this version: 8-~10000 on 8" 


___ 8-10000_on 5" 
SUMMARY 


Version 11.22 of the 2Z80 Cromix Operating System is now 
available. This version corrects problems arising from 
incorrect. handling of the user signal by the Screen editor 
program and the Shell. This version also contains enhanced 
versions of several utility Programs and new hard-disk 
drivers to correct problems arising from timing variations 
encountered with the Model 5007 hard disk. 


< 


User Signal 


Previous versions of the Screen editor and the Shell handled 
the user signal incorrectly. Specifically, if the user 
called a shell from Screen (%) and set SIGenable, it was then 


- possible to kill Screen by sending it the user Signal. Aside 


023-9575 


from potentially destroying the data being edited, this also 


made the shell a parentless process. The new versions of 


these programs correct this problem. 


Blink Utility 


Versions of Blink on previous releases would not allow the 
Specification of a program address less than 100h. . The 
current version of Blink no longer imposes this restriction, 
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Makfs Utility 


In the previous version of Makfs, problems would aris 

-i option was used to create a non-default number of” 
and the number of inodes specified was not a multiple of 4 (¢ 
inodes are contained in a block). Makfs now rounds th 
number of inodes specified by the user down to the nearest- 
multiple of 4. fea ea: a BoE LIE 


a 4 Long tet ‘ ‘ 
% Ae : in : wad 


Tee Program 


In the previous release, the Tee program did not erase old 
files. This problem has been corrected. 


ENHANCEMENTS 


Cptree Utility . tee 7 


The Cptree utility now preserves not only the user and access | 
mode of copied files, but also all the dates (creation, | 
modify, access, and dumped). Copies of files made with the 
Cptree utility are identical to the original in every 
respect. Because the new copy of the file keeps the original 
modify date, copy operations with the -t (time) option will 
behave more naturally. ak 


Copy Utility ae a 
The Copy utility behaves the same way as Cptree. ‘The: copied 
file has the same user, access mode, and dates “as the 
original. : Cee es ee 


The Move utility (when copying from a source file to a 
destination file) behaves the same way as Cptree. The 
destination file has the same user, access mode, and dates as 


the source file. é 


| 

{ 

| 

oe | 

Move Utility te | 
| 

| 


| 
Sim Utility | a. _ 4 
System call 28h is now implemented in Sim. . | 
. | 

| 
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Ceall Utility 


utility: 
Purpose: 


user access: 


summary: 


.arguments: 


‘options: 


Description 


connected to 


cable constry 


Example 


Ccall may Operate at either 300 o 
asynchronous modem Such as the Cromemco MDM-1200, a Bell 
“ 212A, or a Bell 103 type. 

with the modem on +t 
any serial po 
ected for this Purpose, 


using the Cromemco MDM~1200 
another modem) 


e 


all users 


ceall [-q] [-a devname] [-b baud] 
[en Phonenumber] [-w] 


none 


“G9 quiet (default is verbose) 


-d qtty device Name (default is /dev/modem) 
-b baud rate (default is 1200 baud) 
“nN phone number (dashes ma 


y be used in number) 
“Ww wait for manual dial an 


d connection 


It must use an 


he remote System. The 
rt on the Quadart uSing a 12 


rm automatic 


% ecall -b 300 ~n 555-1212 


' uSeS device qtty1! with a co 
Fhe number 555-1212. 
‘ 


-ransmission rate at 300 baud and 
1200 that auto-dials 
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Cceall interprets lines beginning with '™' as special escape 


‘sequences: 


~<€ filename 


~> filename 


« 


“sh 


~sh emd 


Terminate Ccall. ED tet 
Send the line '7...'. To type a line. 
beginning with '~' to the remote computer, you 
must first type '~' twice followed by a 
RETURN; then you can type the rest of the 
line. 


Send the contents of a file to the remote 
system, as though typed at the terminal. 


Divert. all characters received from the remote | 
system into the specified file. '>' may be 
followed by '>' to append the output to the 
file. Either '>' may be followed by ':' to 
specify that the output be sent only to the 
file. If 's:' is omitted, output is written 
both to the file and to the standard output. 
If '>>' is not used, then the file must not. 
exist prior to issuing this command. Typing 
'>' will terminate the diversion. (Full . 
syntax: “~>{>]{:] filename) 


Invoke an interactive shell on the local 
system. , ane 6 


Run the ‘command on the local ee (via shell - 
-c). 


~put [-f] file-list 


Copy the specified files from the ood ‘system 


to the current directory on the remote system. «~ 
If a filename already exists at the.» 


destination, the force option (-f) must be 
used if you want the existing file to be 
overwritten; otherwise, an error will be 


‘reported and the file will not be copied. 


put uses the Sfile and Rfile utilities to 
perform error-free block transfers. Rfile 
must exist on the remote system. 


“take [-f] file-list 


Copy the specified files from the remote 
system to the current directory on the local 
system. If a filename already exists at the 
destination, the force option (-f) must be 
used if you want the existing file to be 
overwritten; otherwise, an error will be 
reported and the file will not be copied. 
take uses the Sfile and Rfile utilities to 
perform error-free block transfers. Sfile 
must exist on the remote system. 


Mm 
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~ Send a one-second break Signal. to the remote 
system. 
~h "| Print a summary of these commands. 


Messages Returned by Ccall 


Now waiting for call to complete ... 
'Ceall is waiting for a connection to be made with another | 
modem over the phone lines. This call can either be dialed 
manually using Bell equipment or the MDM-1200 can dial the 
number and establish the connection automatically. 


No answer -- Call aborted 


If a connection is not established within 120 seconds, Ccall 
exits back to the Cromix shell. 


‘Options 
The -q option keeps Cceall from being too verbose. 


am The -d option specifies which qtty device is to be the 
a transmitter. 


The -b option sets. the baud rate of the transmitting device. 


The =n option Specifies a phone number to be used by the 
MDM-1200 modem. 


The -w option specifies that Cceall is to wait for the 
connection to be manually originated. 


Notes 


If the -w option is used without a phone number, Ceall waits 
for the user to establish a connection manually using 
Standard modem procedures. If the -n option and the -w 
Option are not used, Ccall attempts to establish an 
interactive dialog with the MDM-1200. The user can then use 
all of the features of the -MDM-1200 to establish a connection 
with a remote system (see MDM-1200 manual). 3 
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Rfile utility 


utility: RFILE 
purpose: This program allows binary files to be received 
' from users over the phone lines with error-free 
results. 


user access: all users 


summary: rfile {-q] [-f] [-d device- -name ] [-b baud] . a 
ney dst-directory 7 ha 


arguments: destination directory pathname (must already | 
exist) 


options: -q quiet (default is verbose) 
-f force 
-d qtty device name (default is stdin/stdout) 
-b baud rate (default is current baud rate) 


Description 


The Rfile utility allows binary disk files to be received by 
a user on one Cromix system from a user on another Cromix 
systém that is using the Sfile utility to transmit files.. 


Rfile may operate at either 300 or 1200 baud. It must use an 
asynchronous modem such as the Cromemco MDM-1200, a Bell... 
. 212A, or a Bell 103 type. The modem used must be compatible : 
_ With the modem the Sfile utility is using to transmit the i 
data. The modem can be connected to any serial port on the 
Quadart using a 12-wire cable constructed for this purpose.. 


The qtty driver is used to connect Rfile with the IOP/Quadart © 
and modem. The Cromix system being used must include the 
IOP/Quadart drivers (see Crogen) and a device file for the 
qtty should be set up in the /dev directory using Makdev. 
The corresponding entry in the /etc/ttys file should have a 0 
in the first column. 


Example 
 & rfile -d qtty2 =b 300 recvtemp 
This command line sets the reception rate at 300 baud and 


stores all of the data received from qtty2 into the existing 
‘directory named recvtemp. 


: . 2S ree eee we parr naee enw arene ar amiga IS 
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c Messages Returned by Rfile 


Waiting for Phone call -- 


Receiving [filename] from [devname] into (directory-name] 


A valid connection to the Sfile utility has been established 
and data is being transferred 


from the qtty device to the 
Specified diskfile in the specified directory. 


Connection lost -- ABORT RFILE 


‘The line to Sfile was disconnected Prematurely. 
ABORT RFILE 


. A CONTROL-C Character was received from 


the user at the 
keyboard; Rfile does an orderly exit back to the Cromix 
Shell. 
a Options 4 


The -q option Specifies a different set of Rfile console 
/messages, (Used by Ceall and when Rfile is running on a. 
remote machine, ) 


a 
Hi 

j 
a4 
a 
4 
; 

‘ | 
“| 

Hy 

i 

i 

i 

i 


i y Sfile. If this 
option is not Specifi ile exists with the 


The -d option Specifies which qtty device is to be the 
receiver, | : 


The -b option sets the baud rate of the receiving device, 
Notes 


Rfile is used in conjunction with Sfile. Refer to the Sfile 
utility for additional information. 


“When used without an argument, Rfile displays a-summary of 
the command line syntax. 


SS ae lies Ky I ee oS 


a 
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Sfile Utility 


Utility: SFILE 

purpose: This program allows binary files to be sent 
between users over the phone lines with 
error-free results. . . 


user access: . all users 


summary: sfile fe ql fe d devname] ie b baud] 
pe . {+n phonenumber] [-1 login-name] 
C -p password] file- list 


arguments: one or ‘more filenames 


options: <q quiet (default is eerbose) 
-d qtty device name (default is stdout) 
-b baud rate (default is current baud rate). 
-n phone number (dashes may be used) 
-l1 login name © 
-p password 


Description 


The Sfile utility allows binary disk files to be transmitted 
from a user on one Cromix system to a user on another Cromix 
system using the Rfile utility to receive files. 


Sfile may operate at either 300 or 1200 baud. It must use an 
asynchronous modem such as the Cromemco MDM-1200, a Bell 
212A, or a Bell 103 type. The modem used must be compatible 
with the modem the Rfile utility is using to receive the > 
data. The modem can be connected to any serial port on the 
Quadart using a 12-wire cable constructed for this purpose. 


' The qtty driver is used to connect Sfile with the I0P/Quadart 
and modem. The Cromix system being used must include the 
IOP/Quadart drivers (see Crogen), and a device file for the 
qtty should be set up in the /dev directory using Makdev. 
The corresponding entry in the /etc/ttys file should have a 0 
in the first column. 


If a Cromemco MDM-1200 modem is being used, a telephone 
number can be added to the command line to perform automatic 
dialing. Otherwise, the call must be manually originated 
using standard modem procedures. 


Example 


% sfile -d qtty1 -b 300 -n 555-1212 letter.txt 
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This command line Sets the transmission rate at 300 baud and 


transmits the file letter.txt usi 


connected MDM-1200 that auto-dials the number 555-1212. 


Messages Returned by Sfile 


Now waiting for call to complete 


eee 


Sfile is waiting for a connection to be m 
modem over the Phone lines. 

manually using Bell equipment 
number and establish the connec 


ade with another 
This call can either be dialed 
Or the MDM-1200 can dial the 
tion automatically. 


No answer -- Call aborted 


- If a connection is not established within 60 


seconds, Sfile 
exits back to the Cromix shell. 


Transmitting [filename] to [devname ] 


When a valid connection is established with the Rfile utility 
at the other end, the specified file is then transmitted 
through the Specified qtty device. 


Rfile not responding -- Sfile aborted 


If a-connection is established with another modem, Sfile 
determines if the Rfile utility is ready at that end. ni ome 
Rfile is not running at the other end, or if Rfile is running 
at an incompatible baud rate, Sfile disconnects the line and 


exits back to the Cromix shell. 
Connection lost -- ABORT SFILE 


The line was disconnected in the middle of 
Sfile then exits to the Cromix shell. 


‘ABORT SFILE 


a transmission; 


A CONTROL-C character was received from the user’ at the 
keyboard; Sfile does an orderly exit back to the Cromix 
shell. 


. Options 


The -q - option Specifies a different 


messages (used by CCall and when Sfile 
system). 


set of Sfile.console 
is running on a remote 


The -d option specifies which qtty device is to be the 
transmitter. a 


ng device qtty1 with a. 


a . Sea east 20 AN a ert eget Sons ee 


GREATS Ey 
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The -b option sets the baud rate of the transmitting device... 


The -n option specifies a phone number to be used by the 
MDM-1200 modem. 


The -l option specifies a-login name to be used on the remote 
Cromix system.-: 


| 
i 
| 
i 
! 
i 
i 
i 
i 
i 
i 


H 
; 
| 
i 
i 
i 
j 
i 


The -p option specifies a password to be used on the remote 
Cromix system. 


Notes 


Sfile is used in conjunction with Rfile. Refer to the Rfile 
utility for additional information. 


When used without an argument, Sfile displays a 'summary of 
the command line syntax. 


Flush Utility 


Flush is a new system-maintenance program that flushes (i.e., 
writes to disk) system I/O buffers every specified number of 
seconds, Normally, for efficiency, the Cromix Operating 
System will not write the contents of a buffer to disk until 
it has been completely filled. If you conclude an edit 
session and leave your system running overnight, portions of -. 
your file may reside in system buffers overnight (not written 
to disk). If the system is later abruptly powered down 
without running shutdown, or if there is a power failure, 

. this information will be lost. As a safeguard, it is 
desirable to periodically flush the I/0 buffers using the 
Flush utility. 


The Flush program resides in the /bin directory. It is 
called by typing: 


flush number & 


where: number is the number of seconds between two consecutive 
flushes. Currently the. startup.cmd file is configured to 
invoke Flush, as a background process with an interval of 30 
seconds, every time the system is booted. 


Hard Disk Drivers 


The hard disk drivers have been improved to compensate for 
timing variations in the Model. 5007 five-inch hard disk. In 
the past, timing differences between the writing and reading 
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of data could result in CRC errors, 


reduce the probability of data 
differences, 


The new ‘drivers greatly 
loss: due to timing 


Hdboot 


With the impending release of RDOS 3.08, Cromix systems will 
be able to boot directly from their hard disk, The file 
hdboot, contained in the /ete directory, is included in this 

Provide users who upgrade to RDOS 3.08 with this 
Capability. As with fdboot and Sfdboot, the information 
contained in hdboot can be written to the System tracks using 


wboot. For example, the command "wboot hdO" will write the 
boot information onto hard disk unit 0. 


List Utility 


The List utility has been added to the /bin directory. This 
is an enhanced version of the Standard List utility. When 
called without options, List displays filenames only 


? 
arranged in a multi-column format. Since file length and. 
link count information :-is not displayed, the display is 
Produced much faster than that of the Standard List utility. 
The options to List are unchanged. Specifying any option (or 


just typing ls -) causes the Program to act in the- Same 
Manner as the standard List utility. 


Sim Utility 


The CDOS Simulator, Sim, ‘has been upgraded, It not Only 


SO more flexible than the previous 

ersions, Sim will, by default, 

‘to the Cromix directories /b-/h 

the user can permanently redefine 

& Or, when calling Sim explicitly, Specify 

an alternate mapping. The use of Sim is as described in the 
c 


Cr » xcept for the added Capability to 
Specify different mappings when calling Sim explicitly. 


With this version, however, 


in Sin, Starting at byte location 509h. 
a 16~byte entry for each CDOS directory. 
pathname of the Cromix directory that the Particular CDOS 
directory maps to. The Dump utility may be used to display 
the contents of this table. The entry for CDOS directory A 


Starts at location 509h, the entry for CDOS directory B 
Starts at location 519h, and so on, 2 
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If you want to permanently change the mapping of one or more. 
CDOS directories, you can use the Patch utility to change the. 
contents of this table. The entry for drive A refers to the) 
current directory and should not be changed. When changing. 
an entry: 


1. Each pathname must have a '/' at the end. 


2. Each string must be terminated with a null. 


3. The pathname, including 71% cannot exceed 15 cperserens, 
in length. 


The mapping of CDOS directories to Cromix directories may 
more conveniently be defined when calling Sim explicitly. 
For instance: 


i 
i 
| 
i 


1 
' 
sim -c /usr/lib pathname arguments | 
i 


will refer all references to the CDOS C aaesces to the 
Cromix /usr/lib directory. Thus, one or more CDOS. 
directories may be remapped to specific Cromix directories by) 
typing the letter of the CDOS directory as a flag and then 
typing the Cromix directory as the next argument. Note that 
the pathname of the executable program above must be a 
complete pathname (including extension). The shell's search 
. mechanism will apply: only to the name Sim. 


Version Utility 


. The Version program has been extended to check the 
consistency of a file. In general, if the following string 
of bytes is found anywhere within a file: 


OFDH OEDH OFDH OEDH 


the bytes immediately following are assumed to contain CRC 
information, version number, release number, and program) 
name. When called with the -c option, Version will compute a. 
CRC value for that file. The version of the program actually. 
writing the CRC will be written, in the two bytes immediately 
following the FDEDFDED pattern, followed in the next two 
bytes by the CRC value itself. When called without -c, 
Version reports good or bad file consistency by comparing ai 
newly calculated CRC with the recorded CRC. As before, 
version information about the file is also displayed. Thus, 
Version can be run on the /bin directory, for example, to 
check the correctness and completeness of all executable 
_programs. 


| 
| 
"| 
| 
| 
| 
| 
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To be more Specific, 


oor aii 


consider the following’ portion of a 
file: : 
db OFDH , OEDH, OFDH, OEDH 
db 20,0, 
db version, revision 
db- "program name\n'! 


When called with the -c option, the version/re 
of the Version Program itself will be written 
two bytes following the FDEDFDED 

be written to the fol 


Vision number 
to the first 


Pattern. The CRC will then 
lowing two bytes, . 


/gen/iolib.rel 


Changes to iolib. 


rel include corrections to the 
and a rewritten t 


qtty driver 
yp Printer driver, 


described elsewhere, 


Crogen Program 


€rsion of Crogen. 


(Cos Previous version in a few ways. Crogen 


Size of cromix.sys can be reduced 
of these devices, 


SMD driver (4,0). 


of the SMD hardware and driver, 


TYP - Cromix Typewriter Printer Driver 


Driver has been enhanced. The 
following is a list of new modes, status conditions and 
Special character Sequences. 


Hassett dsl ei aiden Kepilihantlsoes ectotn esl catcacacaeb bt nib nbisscachtoa scalp i ra 


Additional Modes: 


LMargin Left Printing margin in 0.1 inch steps from 
Print position 1, Defines where Printing will 
begin after a RETURN, The printer may be 
backspaced to the left of the left margin 
Setting The printer Will clip at Print 
i x Position 1. | 
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Width 


CWidth 
LHeight © 


Printer Status 


(-) CHECK 


(-)PAPER IN 
(~)RIBBON IN 
(-)ON LINE 


Single Special 


Service Note 


Right printing margin in 0.1 inch steps from 
print position 1. Printer will clip at right 
margin if -WRAParound mode is set or wrap at 
right margin if WRAParound is set. 


Character width. Default spacing between 
characters in 1/120 of an inch. 


Line height. Default spacing between lines in 

1/48 of an inch. 

Conditions Returned By Mode: 
Printer is (not) in a check condition. A 
check condition requires the printer. to 
be reset before use. ; 
Paper is (not) loaded into the printer. 


Ribbon is (not) loaded into the printer. 


Printer is (not) on-line and selected. 


Characters Recognized By the Driver: 


’ (CONTROL=-A) Oth . Toggle Underline 


(CONTROL-B) 02h 
(CONTROL-C) 03h 
(CONTROL-D) O4h 
(CONTROL-E) O5h 
(CONTROL~F) 06h 
(CONTROL-Y) 19h 


(Delete) 7Fh 
80h-BFh 


- COh-FFh 


Line space back 1/2 current line setting 


(begin superscript) 


Line space forward 1/2 current line 
setting (begin subscript) 


Force immediate printing of any 
characters and spacing commands in 
printer buffer 

Enter dot plot mode 

Toggle boldface 

Special mode prefix character (see below) 
Reset printer 


Set temporary CWidth char-80h in 1/120 


of an inch increments 


Variable Width Space = char-COh in 1/120 
of'an inch increments 
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Two Character Special Sequences Recognized by the Driver: 
t, : : 


19h, 80h-BFh Set temporary LHeight = char2-80h in 1/48 
of an inch increments ‘ 


19h, 20h 32 spaces 
19h, 08h 32 backspaces 
19h, 02h Line space ‘back 16. times current line 
| Setting 
19h, O3h Line space forwa 


rd 16 times current line 
Setting ; 
Three Character Special Sequences Recognized by the Driver: 
19h, COh-FFh, COh-FFh Reserved 


For further inf 


: Ormation about Single character commands refer 
oO: . . 
Cromemco 3355A Printer Driver Instruction Manual, part number 
‘ ( 023-4005. - 
CHANGES 
eer 


The section at the end of this file, which equated the old 
names for mode functions to the new na 


mes, has been removed, 
Be sure to refer to all mode functions by their new names, 


Mode Utility 


odified to reflect the changes in the new Typ 
driver, 


Added Files 


The following file has been 


added to the CRO-DL (8~inch) and 
CRO-DS (5.25-inch) diskettes: 


is The Cdosfix utility has pb 
( directory. The Cdosfix Progra 


CDOS to Cromix diskettes, See the file 
/help/édosfix.hlp for documentation, 
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VERSION NUMBER SUMMARY 


_ Files in / 


cromix.iop.sys 1522 -new- 
 cromix.sys * 11.22 -new- 
Files in /bin 

access.bin 00.06 

backup.bin 00.08 

‘blink. bin 00.14 -new- 

boot.bin 00.02 
'ecall.bin 00.07 -new- 

cdoscopy.bin 00.15 

edosfix.bin 00.01 -new- 

chowner.bin 00.06 

empasc.bin 00.05 

compare.bin 00.07 

copy.bin 00.11 -new- 

cptree.bin 00.07 -new- 

day.bin 01.02 

dcheck. bin 00.12 

ddump.bin 02.02 -new- 

deltree.bin 00.03 

dump.bin 00.10 

echo.bin 00.05 

ed.bin 01.45 -new- 

find.bin _ 00.07 

flush.bin 00.01 -new- 

free.bin 00.09 

group.bin 00.01 

h.bin 00.04 

help.bin 00.04 

icheck.bin 00.15 

idump.bin 00.06 

-init.com 02.82 

input.bin 01.00 

l.bin ' 00.11 

ls.bin 00.01 -new- 

mail.bin 02.02 -new- 

makdev.bin 00.07 

makfs.bin 00.13 

maklink.bin 00.04 

match.bin 00.03 

mode.bin 01.15 ~— -new- 

mount.bin 00.14 -~new= 

move.bin *. 00.10 -~new- 
'msg.bin 00.08 

necheck. bin 00.09 

passwd.bin > 00.09 — 

patch.bin 00.03 

priv.bin 00.07 

restore.bin 00.05 

rfile.bin 00.07 -new- 


. root.bin 00.02 
oo 16 
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for 


_ Screen. bin 
Sfile.bin 
Sim.bin 
Sort.bin 
Spool.bin 
tee.bin _ 
testinp.bin 
time.bin 
unmount.bin 
uSage.bin 
‘version. bin 
wboot: bin 
who.bin 


Files in /dev/iop 


cromix.iop 
ioprun. bin 


Files in /ete 
fdboot 
hdboot 
login.bin 
Ssfdboot 


Files in /gen 
crogen.bin 

Ccrolib.rel 

default.bin 
iolib.rel 


01.45 
00.07 
02.65 
00.06 
00.12 
01.03 
01.01 
00.07 
00.11 
00.06 
00.10 
00.09 
00.06 


Thee 
03.00 


00.11 
00.05 
00.02 
00.11 


00.22 


00.02. 
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-new- 
-new- 
-new- 


-new-~ 


“new 


-~new- 


-new— 
~new~ 


~new- 


~new- 


-~new- 
-new- 


